home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk47 / ls22 / ls.doc < prev    next >
Text File  |  1995-03-18  |  4KB  |  104 lines
  1.   LS -- an "improved" directory listing utility to replace the
  2.         AmigaDOS DIR and LIST commands.
  3.  
  4.   V1.0    August 1986 Written from scratch by Justin V. McCormick.
  5.   V2.0  November 1988 Revised for Lattice 5.0 and made 1.3 compatible.
  6.   V2.1  December 1988 Minor size reduction, fixed a few bugs from 2.0.
  7.   V2.2  December 1988 Fixed status return and multiple wildcard pathnames.
  8.  
  9. Notice:
  10.  
  11.   This program is placed in the public domain with the understanding
  12. that the author makes no claims or guarantees with regard to its
  13. suitability for any given application, and that the author assumes no
  14. responsibility for damages incurred by its usage.  Any resemblance
  15. of this program to any other program, either living or dead, is
  16. purely coincidental.
  17.  
  18.   Feel free to borrow this code and make millions of dollars from its
  19. sale or commercial use, but please give credit where credit is due.
  20.  
  21. Synopsis:
  22.  
  23.   Features adaptive columnar listing, versatile sort options,
  24. UNIX-style pattern matching, recursive subdirectory listing, etc!
  25.  
  26. Usage:
  27.     ls [options] [path1] [path2] ...
  28.  
  29. Options:
  30.     -?    Help!
  31.     -c    Show file comment info, -c implies -l
  32.     -d    Show directory names only
  33.     -f    Show filenames only
  34.     -l      Long verbose listing showing filesizes and dates
  35.     -n    No sort, just spit them out in the order ExNext() returns
  36.     -r    Reverse sort direction
  37.     -s    Sorted by size smallest to largest
  38.     -t    Sorted by date oldest to newest
  39.     -R    Recursive descent of subdirectories
  40.  
  41.   All arguments are optional.  Default is to give short columnar listing,
  42. sorted alphabetically, using the current directory.  Alphabetizing is case
  43. insensitive.
  44.  
  45.   Patterns may be matched in the given names, using the UNIX-style '*'
  46. to wildcard any number of characters, and '?' to wildcard a single
  47. character.  If you need to specify a pathname with spaces in it like
  48. "Wombat Soup", you need to put quotes around it.  LS can process up to 30
  49. separate pathname patterns in one command line.
  50.  
  51. Known Bugs:
  52.  
  53.   Redirecting the shortlist output to PRT: gives undesirable results,
  54. since I am using relative cursor positioning commands to format the
  55. screen output.  I thought about using an array to store a virtual
  56. screen, but my primary goals were to keep the size down and display
  57. speed at a maxiumum.  Also, LS cannot pattern match devices (like "dh*:")
  58. or support multiple levels of pattern matching (like "dh0:?/L*.info").
  59. This would involve another level of recursion and groking the Device List.
  60.  
  61. Changes From 1.0 to 2.0:
  62.  
  63.  o Source code prototyped, linted, traced, optimized, tweaked, etc.
  64.  o Made resident ("pseudo-pure") by linking with cres.o from LC 5.0.
  65.  o High-volume routines recoded in assembly (lssup.a).
  66.  o Now handles multiple paths/files on a command line, up to 30.
  67.  o New sort flags, including no sort.
  68.  o Enhanced wildcards, understands complex *.?*.* expressions now.
  69.  o More efficient ExNext() performance, less ram used for recursion.
  70.  o SIGBREAKF_CTRL_C signal (Ctrl-C) cleanly aborts at any point now.
  71.  o Command line parser handles quoted pathnames now (LC 5.0 benefit).
  72.  o Short listing finally auto-adjusts to new console window sizes!
  73.  o Pen color escape codes bypassed when redirecting long output.
  74.  o Sorting by size or date is also subsorted alphabetically now.
  75.  o Long listing shows new 1.3 file attributes, plus comment indicator.
  76.  o File dates are now in international format, YY-MM-DD.
  77.  o Fixed listings with files datestamped after 99-12-31 (overflow).
  78.  o Fixed listings with files datestamped before 78-01-01 (time < 0).
  79.  
  80. Changes From 2.0 to 2.1
  81.  
  82.  o Fixed the show comment feature, a last minute bug in 2.0.
  83.  o Fixed the "Unknown option ''" message problem.
  84.  o Optimized the assembly branches, reduced code size another few bytes.
  85.  
  86. Changes From 2.1 to 2.2
  87.  
  88.  o Fixed erroneous Status returns.
  89.  o Fixed bug with multiple wildcarded pathnames.
  90.  o Compiled with LC 5.0 Patch 3 and CAPE 2.0, saved another 46 bytes.
  91.  o Eliminated an extra stpcpy(), saved another few bytes.
  92.  
  93.   Don't send me money for this one!  Its a Christmas present 8-)
  94. However, if you find any bugs or have any comments I'd like to hear about them!
  95.  
  96.         Justin V. McCormick
  97.     8330 E. Quincy Ave., C-312
  98.     Denver, CO 80237
  99.  
  100.         Home : 303-290-8429
  101.     Work : 303-825-4144
  102.     PLINK: JVM
  103.     BIX  : jmccormick
  104.